Search Products

Search for products by name

GET /api/productos/buscar

cURL

curl --location 'https://api.iquea.com/api/productos/buscar?nombre=mesa'

200 - Success

[
  {
    "producto_id": 1,
    "sku": "IKEA-TABLE-001",
    "nombre": "Mesa de Comedor Moderna",
    "descripcion": "Mesa de comedor elegante con acabado en roble",
    "precioCantidad": 299.99,
    "precioMoneda": "USD",
    "dimensionesAlto": 75.0,
    "dimensionesAncho": 180.0,
    "dimensionesProfundo": 90.0,
    "es_destacado": true,
    "stock": 15,
    "imagen_url": "https://images.iquea.com/mesa-comedor-001.jpg",
    "categoria": {
      "categoria_id": 3,
      "nombre": "Mesas",
      "slug": "mesas"
    }
  },
  {
    "producto_id": 42,
    "sku": "IKEA-TABLE-042",
    "nombre": "Mesa de Café Redonda",
    "descripcion": "Mesa de café compacta ideal para espacios pequeños",
    "precioCantidad": 129.99,
    "precioMoneda": "USD",
    "dimensionesAlto": 45.0,
    "dimensionesAncho": 90.0,
    "dimensionesProfundo": 90.0,
    "es_destacado": false,
    "stock": 8,
    "imagen_url": "https://images.iquea.com/mesa-cafe-042.jpg",
    "categoria": {
      "categoria_id": 3,
      "nombre": "Mesas",
      "slug": "mesas"
    }
  }
]

Authentication

This endpoint is publicly accessible and does not require authentication.

Query Parameters

nombre · string · required

Search term to filter products by name. Returns products whose names contain this string (case-insensitive partial match).

Response

Returns an array of product objects matching the search criteria.

productos · array

Array of product objects matching the search term

Show Product Object

producto_id · long

Unique identifier for the product

sku · string

Stock Keeping Unit

nombre · string

Product name

descripcion · string

Product description

precioCantidad · decimal

Price amount

precioMoneda · string

Currency code

dimensionesAlto · double

Height dimension

dimensionesAncho · double

Width dimension

dimensionesProfundo · double

Depth dimension

es_destacado · boolean

Featured status

stock · integer

Available quantity

imagen_url · string

Product image URL

categoria · object

Category information

Show Category Object

categoria_id · long

Category unique identifier

nombre · string

Category name

slug · string

URL-friendly category identifier

cURL

curl --location 'https://api.iquea.com/api/productos/buscar?nombre=mesa'

200 - Success

[
  {
    "producto_id": 1,
    "sku": "IKEA-TABLE-001",
    "nombre": "Mesa de Comedor Moderna",
    "descripcion": "Mesa de comedor elegante con acabado en roble",
    "precioCantidad": 299.99,
    "precioMoneda": "USD",
    "dimensionesAlto": 75.0,
    "dimensionesAncho": 180.0,
    "dimensionesProfundo": 90.0,
    "es_destacado": true,
    "stock": 15,
    "imagen_url": "https://images.iquea.com/mesa-comedor-001.jpg",
    "categoria": {
      "categoria_id": 3,
      "nombre": "Mesas",
      "slug": "mesas"
    }
  },
  {
    "producto_id": 42,
    "sku": "IKEA-TABLE-042",
    "nombre": "Mesa de Café Redonda",
    "descripcion": "Mesa de café compacta ideal para espacios pequeños",
    "precioCantidad": 129.99,
    "precioMoneda": "USD",
    "dimensionesAlto": 45.0,
    "dimensionesAncho": 90.0,
    "dimensionesProfundo": 90.0,
    "es_destacado": false,
    "stock": 8,
    "imagen_url": "https://images.iquea.com/mesa-cafe-042.jpg",
    "categoria": {
      "categoria_id": 3,
      "nombre": "Mesas",
      "slug": "mesas"
    }
  }
]

Status Codes

200 · OK

Successfully retrieved matching products (may be an empty array if no matches found)

The search performs a case-insensitive partial match. Searching for “mesa” will match “Mesa de Comedor”, “MESA DE CAFÉ”, etc.